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A. 


SOFTWARE UNIT: 


I dent . 

Rev. 

Card Count 

REMl A (Macro Library) 

0 

41 


■r 

REMlB (Macro Library) 

0 

42 


REMlC (Macro Library) 

0 

41 


TBP8 (Relocatable) 

0 

8 


G?XX (Relocatable) 

0 

11 



r 



B • REASON FOR RELEASE : 

1. To correct the following problems in REMl : 

a. A "READY" (X 1 05 ' ) keyin would be ignored after a special forms 
message from the 1108. 

b. It was difficult or impossible to execute subsequent programs 
without rebooting the Operating System after running REMl, 

c. REMl was incapable of operating the printer at more than half 

of rated print speed, regardless of modem speed or print line size. 

d. Certain characters in the card input to REMl were erroneously 
translated as EOM characters, leading to unrecoverable errors. 

2. To implement the following enhancements to REMl: 

a. It is now possible to generate and assemble REMl on an 8-K machine 
(standard reader plus either serial or row punch) . 

b. It is now possible to specify that card image input or output will 
be accomplished by means of user-supplied routines, thus permitting 
input/output of tape, disc, paper tape, or other kinds of files. 

c. Issuance of CNTRL macros to achieve maximum possible punch speed if 
card output is to the serial punch. 

C . SOFTW A RE R ESTR ICTIONS : 

None . 

D . HARDWARE CONFIGURATIO N : 

1. 9200/9300 with 8-K memory. 

2. Card Reader. 

3. Serial Punch or Row Punch. 

4. Bar Printer. 

5. DCS— 1 or DCS-4 . 

E • SPE CIAL NOTES : 

1. Since the majority of REMl users operate 8-K card system terminals, 
the REMl macro library was broken into three smaller macro libraries 
so as to facilitate generation on the same machine as REMl will be 
operated upon. To generate the REMl source deck, it is necessary to 
operate the Macro Generator once with each library (REMl A, REMlB, and 
REMlC) . The macro calls REM1A, REMlB, REMlC, are used with the 
respective libraries along with the same keyword parameters and 
specifications for each call as were formerly used in generating REMl 
(see 3 to 5 below for new parameters) . The label which is punched in 
the REM1A macro call card is generated into the START line to permit 
distinguishing between different versions of the REMl main program. 

The END card which is punched by each of the first two preassembly 
macro passes must be discarded; the END card for REMlC must read 
"END G?Z"; the source decks punched by the macro generator must be 
submitted to the Assembler in REM1A _ B - C order. If assembly is 
done on an 8-K machine, a "CTL ,8191" statement must precede the 
REMl source deck in the Assembler's input. See Appendix A for 
diagram of generation procedures. 
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The EBCDIC-to-compressed translate table, TBP8, has been made a separate 
relocatable element. It must be included in the linker run which pro- 
duces the loadable REMl object deck whenever OUT=OWNCD ij3 not specified 
and/or IN=OWNCD d^s specified. The compressed- to-XS 3 translate table, 
G?CX, and the XS3-to-EBCDIC translate table, G?XE, have been combined 
into a separate relocatable element, G?XX. It must always be included 
in the input to the linker when producing a loadable REMl . 

The unnecessary keyword parameter "DEVA" has been deleted. REMl does 
not, and has never, inspected or altered logical/physical unit tables. 

Two new parameters may be specified, "IN" and "OUT". Possible speci- 
fications are as follows: 

a. IN=OWNCD, if the programmer provides his own routine to replace the 
normal card input routine. 

b. OUT=OWNCD , if the programmer provides his own routine to replace 
the normal card output routine. 

c. OUT=SERP , if card output is to the serial punch. The serial punch 
IOCS which is generated for linkage to REMl must include the 
specification CNTL=YES if OUT=SERP is specified, since REMl will 
issue CNTRL macros to the punch IOCS to limit the number of 
columns punched. 

If the operating system under whose control REMl is to be executed is 
of NCOS or higher level, SYST=TAPE must be specified, regardless of 
whether that system is tape- or disc-resident. 

If IN=OWNCD is specified, REMl will assume that its input will be in 
EBCDIC and will consist of images that would make up a normal 1108 
run deck. The input file must be assigned the label G?CI ? REMl issues 
3 macro instructions to this file, OPEN, GET, and CLOSE. If the 
complexity of the input data is such that REMl should not attempt to 
reference the actual input file directly, the programmer should be 
aware that the assembler generates the following calling sequences 
for the various macro instructions: 


OPEN 

BAL 

14, filename 

CLOSE 

BAL 

14, f ilename+4 

GET 

BAL 

14, f ilename+8 


DC 

Y(workarea address) 

PUT 

BAL 

14, f ilename+16 


DC 

Y(workarea address) 


If the user programmer wished to cause the reading of 100-byte tape 
records for transmission to the 1108, the following "OWNCD" input 
routine would probably suffice: 


INPT 

START 0 



TPIN 

DTFMT 

DEVA=2 , BKSZ=400, RCSZ=100, WORK=YES , etc . , 

etc. 

HDLR 

DMTIO 

WORK=YES , etc . , 

etc. 



ENTRY 

G?CI 



G?CI 

BC 

15, OPEN 




BC 

15, CLOS 



GET 

BC 

0 , PAR2 

BC 15 IF 2ND HALF OF 

RECORD 


STH 

14,GETX+2 

SAVE RETURN 



GET 

TPIN, W100 

READ TAPE RECORD 



CLI 

W100, C 'd> 1 

1108 CONTROL CARD ? 



BC 

8, *+8 

SKIP NEXT LINE IF SO 



MVI 

GET+1 , X 'F0 1 

SET PART-TWO SWITCH 



LH 

14,GETX+2 




LH 

15 , 0( , 14) 

LOCATE REMl ' S WORKAREA 


MVC 

0(80,15) , W100 

MOVE 1ST 80 BYTES OF 

TAPE RECORD 


AI 

GETX+2, 2 

ADJUST RETURN 


GETX 

BC 

15,0 

RETURN 


PAR 2 

MVI 

GET+1, 0 

RESET PART-2 SWITCH 
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LH 

15, 0( , 14) 

FIND REMl WORKAREA 


MVC 

0(20,15) , W100+ 80 

MOVE REMAINDER OF TAPE 


MVI 

20(15), C' ' 

BLANK-FILL REST 


MVC 

21(59,15) ,20(15) 

OF REMl WORKAREA 


BC 

15, 2 ( , 14) 

RETURN 

OPEN 

STH 

14, *+10 



OPEN 

TPIN 

OPEN TAPE FILE 


BC 

15,0 


CLOS 

STH 

14, *+10 



CLOSE 

TPIN 

CLOSE TAPE FILE 


BC 

15,0 


W100 

DS 

CL 100 

TAPE WORKAREA 


END 




If an actual 1108 run deck is being read from tape, REMl will never 
cause the tape IOCS' EOFA routine to be entered. A halt or error 
recovery routine could be placed at the label which is assigned to 
the EOFA parameter. The OWNCD routine must store and reload any 
registers other than 14 and 15 which it uses. 

7. If OUT=OWNCD is specified, REMl will assume that its output will be 
in EBCDIC and will deliver those images which are transmitted to it 
by the 1108 for punching. The output file must be assigned the label 
G?CO; REMl issues 3 macro instructions to the output file, OPEN, PUT, 
and CLOSE. See the input own-code example above for typical coding 
where the complexity of the data being transferred does not permit 
REMl to reference the actual I/O routine. NOTE - if the only deviation 
from normal card output is to be translation to other card codes, this 
may be accomplished by substituting the desired EBCDIC- to-compressed 
translate table for TBP8 and by equating "TBP8" to the name of the 
user-supplied table in the linker run. 

8. When REMl is executed, it does not open its reader file until such time 

as a "READY" (X'05') keyin is made. When a "READ CARDS" (X'06') keyin 
is made, it ignores all card input until a card with "@RUN" in columns 
1-4 is encountered;- this is the first card to be transmitted to the 
1108. Then, when a card with in columns 1-2 is read, it stops 

reading cards. If no cards are to be transmitted to the 1108, suf- 
ficient cards must be in the reader so as to prevent a hopper-empty 
halt; under NCOS, a "DATA C" card, followed by "/*", followed by valid 
control stream cards must be present. 

9. REMl does not go to its End-of-Job routine until an "OFFLINE" (X'0C') 
keyin is made. Its execution must be terminated by this keyin to 
insure proper closing of all files. The unnecessary X'6606' halt 
has been eliminated; under MOS, REMl will cause the Supervisor's 

X ' 41EF ' halt to occur upon normal completion; under NCOS, Job Control 
will be loaded and the remainder of the 9300 Control Stream will be 
processed. 

10. A new REMl macro library and the TBPS and G?XX relocatables will be 
included in the next tape and 8411/8414 disc software updates. REMl 
will continue to be distributed as a single macro to recipients of 
tape and disc software. 

ORDERING PROCEDURES : 

The REMl software package described herein is available upon request in 

card format. It may be ordered by forwarding the attached "Software 

System Support Request" directly to Software Order Services. 

Sperry UNIVAC 9200/9300 Software Coordinator 
Sperry UNIVAC - Software Order Services 
P. O. Box 500 

Jolly Road & Township Line Road 
Blue Bell, Pennsylvania 19422 
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Note ; All users outside the United States should check with their local 
UNIVAC subsidiary office for distribution procedures. The above 
applies to United States customers only. 

G. DESTRUCTION : 

This memo supersedes and orders the destruction of 9300 Release Memo #83 
dated January 8, 1971, as well as the former REMl Macro Library (Rev. 5) 
distributed with that memo. 
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PHILADELPHIA DEVELOPMENT CENTER 




i* n box soo 

HI Ilf BEIL. PENNSYLVANIA 19422 
ll I E PHONE 121 SI 642-4011 


SOFTWARE ORDER SERVICES 
~~ (215) 542-3421 


SOFTWARE SYSTEM SUPPORT REQUEST 
DIV. MKT. ORGN. ASSIGN. 


SOFTWARE REQUESTED 


MEMO H DATE MEDIA REQUIRED 


ft REM I (PACKAGE) DECK 


122 7.23-73 


Q 


D 

□ 

□ 

P 

P 

** CHECK BOX FOR SOFTWARE REQUIRED. 


REQUESTED BY: 



ATTN: 


SIGNATURE APPROVED 
USER D. P. MGR/LOCAL S. A. MGR. 


SPECIAL INSTRUCTIONS: 

SEE ORDERING PROCEDURES PAGE 3 of 4. 


REMARKS AND/OR ADDRESS CORRECTION SEND REQUEST FORM TO: 

SPERRY UNIVAC 

SOFTWARE ORDER SERVICES 

TOWNSHIP LINE AND JOLL Y RD. 

BLUE BELL , PA. 19422 


i 



■ i 

NOTE: ALL USERS OUTSIDE THE UNITED STATES SHOULD CHECK WITH THEIR 
LOCAL UNIVAC SUBSIDIARY OFFICE FOR DISTRIBUTION PROCEDURES. 


SPER^Y-^UNIVAC 


i 


